Natural Intelligence is pleased to provide you with Roaster DR 2.1. The Roaster team is very excited about this release as it brings you the key source level debugging functionality you have been waiting for. The development team has put a great deal of time and effort into this release and we are certain you'll find the addition of the debugger and other improvements valuable to your development efforts. Thank you for your support and continued interest.
Please note the important information below for use of this release.
This is an update to Roaster™ Developer Release 2.0. You must be a registered Roaster™ user in order to use this update.
Contents of Developer Release 2.1
Roaster™ DR2.1 Read Me - This document
Roaster™ IDE Updater - Updates Roaster™ IDE 2.0 to 2.1
Applet Runner Updater - Updates Applet Runner 2.0 to 2.1
User Guide addendum - revised chapter 6, Debugger documentation
Known Issues
New features in Developer Release 2.1
The most signficant new feature in Developer Release 2.1 is the addition of source level debugging. A revised chapter 6 to the user guide is included with this release in .pdf format to describe use of the debugger.
Several .net related bugs have been fixed, and support for DatagramSockets implemented.
The Applet Runner will now use the Global class paths list set in the IDE class path preferences. It will not yet, however, use the Project class paths list.
The Make and Compile facilities are faster.
Installing the Update
Installation of the update involves updating two applications, the Roaster™ IDE and the Applet Runner. The updaters will update the IDE and Applet Runner from DR2.0 CD. Perform the update as follows:
1. In the Roaster™ Update 2.1 folder, double click the Roaster™ IDE Updater. A navigation dialog will be presented. Navigate to the Roaster™IDE on the CD and click on the Update button. A copy of Roaster™ DR2.1 will be created.
2. In the Roaster™ Update 2.1 folder, double click the Applet Runner Updater. A navigation dialog will be presented. Navigate to the Applet Runner on the CD and click on the Update button. A copy of the Applet Runner DR2.1 will be created.
Important - be sure to place the Roaster™ IDE and Apple Runner in the Roaster™ folder with the classes.zip file.
3. Drag the Roaster™ IDE.pref file to the trash.
Known Issues
It may be necessary to resize the Breakpoints window the first time it is opened to get the breakpoints to display.
The "Known Issues" list is maintained on our website at: <http://www.roaster.com/support/roasterknownissues.html>
Change Log
Changes to Roaster Applet Runner
The Applet Runner should now use the global classpath preferences.
The DatagramSocket class in java.net is now supported.
Opening an IP address and failing to connect to the host will not hang indefinitely, nor will opening an invalid IP address. This was a problem in the past that has been fixed for this release.
The Math class had been experiencing problems with negative numbers. This is now resolved. One example was division by -1 giving ridiculously large numbers.
Changes to Roaster IDE
A crashing problem for 68k machines while debugging was fixed.
Changed to update the breakpoints window when the current project changes
Fixed bug in parser that would treat the following line
public int construct_position_x = 125, construct_position_y = 30;
incorrectly, it through that construct_position_y was package, not public
Fixed problem in class tree where the lists wouldn't get disposed. besides leaking a lot of memory, it also could leave extended list manager items floating for nfinity.
Fixed step over and step in continuous. Now they do.
Fixed bug where if you cancelled closing a window when doing a close all, it would keep asking you until you said save or don't save.
Changed local variables window so that when you step, you don't have to reopen the local variable fetts again each time.
Fixed bug in object inspector window which would make any variable in the fetted level above an open fetted object show the wrong value and object and lots of other stuff. This was a very naughty bug.
Fixed a problem where the floating debugger tool pallette would go behind the browser.
Changed so debugging browser always comes to front when we return from the debugger.
Disabled "Enable Debugger" menu item when the debugger is running
Stopped the debugger controls from disappearing when you step or any time you switch out of the IDE.
Updated HTML path to sun's javadoc info.
Changed clicking the debugger controls so it clicks better and won't need extra clicks.
Fixed linker to auto add certain classes (what you ask is the linker ;-) )
Now you can set a source breakpoint in a file that is not in the current project as long as it is in another open project. In R3 we will be able to set the breakpoint even if it is not in a file that is in any project.
Started passing the -d parameter to javac so that the class files will be dumped in the proper folder relative to the project file's directory.
Fixed problem where browser would not properly restore the remembered editor height preference when being reopened.
Added remembering the current settings for class tree windows
Changed icons for debugger toolbar to make it a little more clear as to which ones the step in, over and out are.
Added the linking startup class name in 'STR ' 0 in the link application thing. Hmmm..again with the linker. What could they be talking about?
Fixed redraw bug in browser editor when it is activated, the hi light would draw incorrectly until the area is scrolled out, then back.
Fixed bug where browsers would not automatically be saved before a make or compile.
Fixed file synchronization stuff so that it updates the syntax colors when the file's name is changed in the Finder.
Fixed problem in Replace all where the scroll bars would not be properly set afterwards.
Upped max stack list depth to 50 from 10
Made it possible to add untitled windows to the project (it asks you to save first).
This saves a menu step.
Added a (overly) clever alert when an exception is thrown so that the user knows that is why
they have returned to the debugger. Currently, it only beeps the first time, after
that, you see the alert but it there is no beep.
Moved source and breakpoint view items into the Debug menu
Removed Monitor item from Debug menu
Added the method name to the debug markers for source files.
Break on exceptions should work now.
If we can't find the source or bytecode file, we deal more gracefully now.
Started staggering debugger windows
Changed DebugMarkersChanged so that if there is an error setting the marker in the VM (like if it doesn't match to a line) it will remove it or disable it, depending on when the marker is being set. The reason it isn't always being removed is because if you set a breakpoint in the wrong place while the debugger isn't active and the debugger becomes active, you may want to be able to double click on it to see where it was and set it to the right place.
If you are debugging and you start to type, it will ask if you really want to change the code since it could affect breakpoints.
Got rid of extra calls to rebuild the method list in the browser since they seem to be unnecessary and they were forcing the browser to be rebuilt which would change the current file if list items were selected but the debugger was setting the current file.
Changed browser to not update lists when stepping in the debugger
Added ability to remove breakpoints by selecting some in the breakpoints window
and hitting delete.
Added object inspector window which will show the values of an object or the contents of an array when you double click on an item either in another inspector window or in the locals window
Added type ahead variable name and method name completion. If you type the first part of a local variable, instance variable or method that is defined or declared above the cursor in the current class, you can then hit the escape key and it will complete typing that name for you. If its a method, it will also type the () and put the cursor between them. In the future this will be smart enough to know if you type this.in, it could complete this.init() or some such. It checks local variables first, then instance vars, then method names.
Added ability to open the debugger controls from the menu and close them from a close box.
Got rid of current object inspector and runtime status menu items since there are no corresponding windows anymore.
Changed HTML syntax coloring to only do line break recalculation if some of the styles
changed.
Changed make to pass all of the files we will be making to the compiler at the same time. This speeds things up a lot and lets the compiler be more intelligent about it.
Added more intelligence message parsing to display the progress of javac compiles.
If trying to save a project results in an error, the user is given the option of closing the project anyway.
Changed javac compiling to show status messages less often, this results in about a 25% speed increase in compiling.
Added control popup in the browser that does cut, copy, paste, and lets you switch between source and bytecode debugging.
When doing replace all in a window, we show the percentage that we are through the window as we do the replaces.
If option is down when single step scrolling, we scroll by 2 lines, effectively doubling scrolling speed.
Added new breakpoints window which let you switch between the three breakpoint types and let you configure a condition on the breakpoint. Now if we only had the expression evaluator.
